home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / system / dlxdr243.zip / DDIR.DOC next >
Text File  |  1994-12-12  |  14KB  |  343 lines
  1. ******************************************************************************
  2. *                                                                            *
  3. *                             D e l u x e    D i r                           *
  4. *                                                                            *
  5. *                                 Version 2.43                               *
  6. *                                                                            *
  7. ******************************************************************************
  8.  
  9.  
  10.                                Table of contents:
  11.                                ------------------
  12.  
  13.                              1.   Program description
  14.                              2.   Validation
  15.                              3.   Requirements
  16.                              4.   Features
  17.                              5.   Installation
  18.                              6.   Program use and options
  19.                              7.   Comments
  20.  
  21.                     Appendix A:   Version notes and additions
  22.                     Appendix B:   Contacting the author
  23.  
  24.  
  25. 1. Program description:
  26. -----------------------
  27.  
  28.    Deluxe Dir (DDIR) is an experimental Pascal program which turned out to
  29.    be quite a useful directory-lister program. The main advantage of DDIR
  30.    is that it lists the directory files in three columns, instead of the one
  31.    column used by the 'dir' command, yet showing the file sizes, which are
  32.    usually quite important and are not shown by the 'dir /w' command.
  33.    In addition, DDIR adds a few options which are described below, making
  34.    the directory screen appear more clearly and efficiently.
  35.  
  36.  
  37. 2. Validation:
  38. --------------
  39.  
  40.    In order to ensure that the file has not been altered, I'm including the
  41.    info that would be provided by McAfee's VALIDATE Ver. 2.00 program:
  42.  
  43.    DDIR.EXE     15044   12-12-94   10:29p  AA12  20D6
  44.  
  45.  
  46. 3. Requirements:
  47. ----------------
  48.  
  49.    A. CGA or higher graphics adapter
  50.  
  51.    B. 80286 or higher microprocessor
  52.  
  53.    C. A hard disk
  54.  
  55.    * This program has been tested on MS-DOS 3.1 and MS-DOS 6.2.
  56.  
  57. 4. Features:
  58. ------------
  59.  
  60.    * Directory is listed in three columns separated by two vertical lines.
  61.  
  62.    * Executable files are highlighted.
  63.  
  64.    * Compressed archive files appear in a different color.
  65.  
  66.    * Hidden and system files are shown along with the regular files.
  67.  
  68.    * The directory can be sorted primarily by filename, extension or size,
  69.      and the files are displayed in vertical order.
  70.  
  71.    * Hebrew filenames can be shown in Hebrew characters.
  72.  
  73.    * Wildcards are handled better than in the DIR command.
  74.  
  75.    * File sizes may be shown in kilobytes.
  76.  
  77.    * The '.' and '..' directory files are ignored.
  78.  
  79.    * The directory files are pushed to the beginning or end of the list.
  80.  
  81.    * The file sizes contain commas.
  82.  
  83.    * Zero length files are made to blink for easy detection.
  84.  
  85.    * DDIR contains a detailed option which shows the file attributes,
  86.      dates, times and the size of the drive being listed.
  87.  
  88.    * The number of files in the subdirectory, the size of the subdirectory
  89.      and the number of bytes free are displayed at the end of the directory.
  90.  
  91.  
  92. 5. Installation:
  93. ----------------
  94.  
  95.    DDIR.EXE is the only file needed for the operation of DDIR. However,
  96.    In order for DDIR to be able to run from any path, one of two methods
  97.    must be used:
  98.  
  99.    A. The PATH method:
  100.  
  101.       1. Copying DDIR.EXE to a subdirectory on the hard disk.
  102.  
  103.          For example, if the source is drive a: and the target is the
  104.          'utils' subdirectory, tyep the following line from the DOS prompt:
  105.  
  106.          'copy a:ddir.exe c:\utils'
  107.  
  108.       2. Including the subdirectory in the PATH environment variable.
  109.  
  110.          For example, include the following line in your AUTOEXEC.BAT:
  111.  
  112.          'path c:\;c:\utils'
  113.  
  114.    B. The ALIAS method (recommended):
  115.  
  116.       1. Copying DDIR.EXE to a subdirectory on the hard disk. (look above)
  117.  
  118.       2. Running an alias program like DOSKEY, giving DDIR a very short
  119.          alias like '-'. (The alias could also include default command
  120.          line switches.)
  121.  
  122.          For example, include the following line in your AUTOEXEC.BAT:
  123.  
  124.          'c:\dos\doskey -=c:\utils\ddir.exe /e $*'
  125.  
  126.  
  127. 6. Program use and options:
  128. ---------------------------
  129.  
  130.    The command line syntax for DDIR is:
  131.  
  132.    >ddir  [/para]  [/para]  [drive][path]  [/para]  [/para]
  133.  
  134.    (In case the alias method is being used, use '-' instead of 'ddir',
  135.     or whichever alias has been installed.)
  136.  
  137.    All of the parameters of DDIR are optional, and when a parameter is not
  138.    specified, DDIR automatically chooses the default option. All the parameters
  139.    must be preceded by a slash, and separated by spaces. Each time a parameter
  140.    is specified, it inverts the last state of the option it stands for.
  141.    Therefore, a parameter has to be specified an odd number of times in order
  142.    to be effective. The default drive and path for DDIR are the current drive
  143.    and the current path. Its default wildcards are the same as DOS's default
  144.    wildcards (*.*).
  145.  
  146.    These are the parameters that represent the options of DDIR:
  147.  
  148.    /C   -  This option allows the omission of commas in the file sizes and
  149.            the bottom statistics. It is mainly made for users who need faster
  150.            speed.
  151.  
  152.    /D   -  The detailed option shows the files in one column, thus allowing to
  153.            add display of files' attributes and dates, and the size of the
  154.            drive being listed.
  155.  
  156.            The abbreviations for the files' attributes are:
  157.            H - hidden;  R - read-only;  S - system;  A - archive
  158.  
  159.            Scrolling of the screen is performed by these keys:
  160.            PgUp                  - Scrolls one page up.
  161.            PgDn, Space and Enter - Scroll one page down.
  162.            Home                  - Jumps to the beginning of the list.
  163.            End                   - Jumps to the end of the list.
  164.  
  165.            The Space and Enter keys are for scanning the list from beginning
  166.            to end, and returning to DOS after viewing the last page.
  167.  
  168.            Changing drives:
  169.            When the detailed display is active, the path can be changed to the
  170.            current path of a certain drive, by pressing the CTRL key and the
  171.            drive letter simultaneously. DDIR will then show the new directory,
  172.            according to all the other options specified at the command line.
  173.  
  174.    /E   -  Sorts the files primarily by their extension. Please note that the
  175.            default option sorts the files primarily by name, but sorts their
  176.            extension too. This option sorts files of the same extension by
  177.            their name. (Cannot be used with /Z)
  178.  
  179.    /H   -  This option was made for Israeli users who use Einstein
  180.            HebrewWriter or any other program that makes pseudo Hebrew
  181.            filenames using the IBM extended character set. When this switch
  182.            is active, the program will translate these characters to Hebrew
  183.            characters. 
  184.  
  185.    /I   -  Used in order to enter wildcards. The acceptable wildcards are
  186.            asterisks and question marks. Asterisks represent (as usual)
  187.            a sequence of zero or more letters, but question marks stand for
  188.            EXACTLY one character (which is different from DIR's). Wildcards
  189.            with both asterisks and question marks are not allowed. (Cannot
  190.            be used with /X)
  191.  
  192.            Examples:
  193.  
  194.            >ddir /i*.exe
  195.            >ddir /i*exe
  196.  
  197.            Both commands will show all EXE files.
  198.  
  199.            >ddir /x*a.*
  200.  
  201.            The command will NOT show all files whose filename ends with an 'A'.
  202.  
  203.    /K   -  Shows the file sizes in kilobytes instead of bytes. (The size in
  204.            bytes is always rounded upwards). This option helps figure out the
  205.            proportions between sizes of files, and see how much space a
  206.            certain file occupies. (Usually, a file occupies a multiple of
  207.            2 Kb's on fixed disks, and a multiple of 1 Kb on floppy disks).
  208.  
  209.    /L   -  Displays files in lower case characters, leaving the first one
  210.            capitalized.
  211.  
  212.    /P   -  Pushes directory files to the end of the list: Sometimes it is more
  213.            convenient to see the directories while typing a command, by moving
  214.            them to the end of a long list of files. This option is active only
  215.            when sorting is active.
  216.  
  217.    /R   -  Reverses the order of sort to descending sort. It is especially
  218.            useful for size sort.
  219.  
  220.    /S   -  Skips sorting of files and shows them by DOS order. This option is
  221.            needed only when greater speed is desired, or when the actual order
  222.            of the files of a certain directory needs to be shown.
  223.  
  224.    /T   -  This option disables the text mode changes at the beginning and end
  225.            of program execution. It is needed only for EGA/VGA users who use
  226.            special TSR program drivers or unique pallettes.
  227.  
  228.    /V   -  Enables snow checking for old video adapters: Some old CGA's and
  229.            other graphics adapters produce an effect called 'snow' when
  230.            characters are output directly to the screen. If such a 'snowing'
  231.            effect occurs, this option should be specified.
  232.  
  233.    /W   -  Swaps the position of the day and the month in the detailed
  234.            option's file dates for country compatibility. The month is
  235.            displayed by letters.
  236.  
  237.    /X   -  Excludes files matching the following wildcards. Used exactly
  238.            like /I. (Cannot be used with /I)
  239.  
  240.    /Z   -  Sorts files by their size from small to large. (Cannot be used
  241.            with /E)
  242.  
  243.    /?   -  This option shows a title screen and a summary of the allowed
  244.            options.
  245.  
  246.  
  247.    Abortion:   DDIR can be terminated whenever it is waiting for a key press
  248.                by pressing the <Esc> button.
  249.  
  250.    Exit codes: DDIR uses the following exit codes:
  251.  
  252.                3: when an error occurs
  253.                2: when DDIR has been terminated
  254.                1: when help has been requested
  255.                0: otherwise
  256.  
  257.  
  258. 7. Comments:
  259. ------------
  260.  
  261.    *  The programmer disclaims any responsibility for damage caused by this
  262.       program, though the program does not write on or change the contents of
  263.       any device it reads from, and does not stay resident in memory.
  264.  
  265.    *  Any suggestions or comments about the program will be gratefully
  266.       accepted.
  267.  
  268.    *  This program may be distributed as long as its contents are not changed
  269.       and no fee is charged. (The ZIP form is more recommended for
  270.       distribution.)
  271.  
  272. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  273.  
  274. App. A: Version Notes And Additions:
  275. ------------------------------------
  276.  
  277.    2.43: Improves comma additions for large file sizes, improves coloring,
  278.          highlights compressed archives, fixes a bug in wildcard parsing
  279.          and improves Ctrl-C/Break detection.
  280.  
  281.    2.42: Allows using both /L and /H, speeds up the /L routine, has a better
  282.          help screen, a better parameter parsing method, wider display and
  283.          better error handling. Different drives can be viewed by a CTRL-key
  284.          command.
  285.  
  286.    2.41: Improves the detailed option: displays files' month in letters, and
  287.          adds page-leap scroll. Also fixes display bugs in version 2.40.
  288.  
  289.    2.40: Introduces its own wildcard parsing routine, instead of DOS's
  290.          routine, which doesn't work correctly. Also adds title, displaying
  291.          of path and wildcard selection, and displaying of directory
  292.          filenames' extensions in parentheses.
  293.  
  294.    2.31: Improves Hebrew display, blinks zero length files, adds an
  295.          option for lower case characters and no longer highlights .COM
  296.          .BAT and .EXE files which are also system files, as they are not
  297.          executable from the command line.
  298.  
  299.    2.30: Adds sort by size and descending sort. Improved display. Adds
  300.          abortion with <Esc>. Fixes a bug when a color graphics adapter
  301.          is not present. Stricter parameter checking.
  302.  
  303.    2.24: Adds time display and allows swapping the day and month
  304.          position of the dates (all in the detailed option).
  305.  
  306.    2.23: Allows canceling of program text mode changes.
  307.  
  308.    2.22: Returns to original text mode, allows snow checking.
  309.  
  310.    2.21: Adds an option to omit commas, and fixes some bugs which occurred
  311.          only in ver. 2.20.
  312.  
  313.    2.20: Improved screen usage in small directories, adds extension
  314.          sort, allows skipping sort, adds an option for pushing directory
  315.          files to the end of the list, and adds commas to file sizes.
  316.  
  317.    2.12: Improved path and current directory handling.
  318.  
  319.    2.11: Fixes a little bug with empty disks which have no volume label
  320.          and improves error messages.
  321.  
  322.    2.10: Adds Hebrew support to Einstein HebrewWriter style filenames.
  323.  
  324.    2.00: Sorts filenames and enhances executable ones. (Initial release)
  325.  
  326. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  327.  
  328. App. B: Contacting the author:
  329. ------------------------------
  330.  
  331. Mail address:
  332.  
  333.      Oren Souroujon
  334.      Hanasi Harishon St. 38/29
  335.      Rehovot, 76302
  336.      ISRAEL
  337.  
  338. E-Mail Internet address:
  339.  
  340.      LISOURO@weizmann.weizmann.ac.il
  341.  
  342. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  343.